home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac 1993 September / September 93.iso / Archives / Fun, Tricks & Hacks / BellChoir / read me < prev   
Text File  |  1992-06-19  |  4KB  |  63 lines

  1. Copyright © 1992.  Kathleen Brade  All Rights Reserved.
  2. #include <StdDisclaimer.h>
  3. /* BELL CHOIR IS A HACK; There may be bugs in it; Use at your own risk */
  4.  
  5. "Bell Choir" (Conductor and chorus) was done as an experiment for MacHack '92.  There are one or two known bugs in the software and incompatibilities (see System Requirements below).  It has a conductor which picks the songs (text files) and sends them out to other Macs on the local zone running chorus.  You can write your own favorite songs to be played (see section below).
  6.  
  7. SYSTEM REQUIREMENTS
  8. It uses Apple Events and some of the new sound manager calls so System 7 is a good thing.  Also, you'll need machines with the Sound Chips (2 sound channels).  
  9.  
  10.  
  11. USAGE
  12. Run conductor on one Macintosh.
  13. Run chorus on any other Macintoshes you wish you join in.
  14. Choose the music on the "conductor" application.  
  15. When you click the "play" button, the conductor looks over the local AppleTalk zone for other Macs with "chorus" running.  (A desired feature of a future versions is to have the conductor launch the application (chorus).)  It then distributes the parts among the machines that it finds--each machine playing just its assigned notes. 
  16. To QUIT, press any letter or number on the keyboard. 
  17.  
  18. NOTE:  "chorus" must be the name of the application.
  19.  
  20. A potential problem you might have is that program linking is not on in "Sharing Setup" or that the account you login (guest or an actual account) is not permitted for program linking.
  21.  
  22.  
  23. PICKY PROBLEMS
  24. If you hear a Beep (rather than a note), you probably found a bug or an incompatibility.  (It's better to beep than to see a bomb!)
  25.  
  26. Bell Choir does NO checking for system versions and to ensure other characteristics are present (AE, Sound, etc).  
  27.  
  28. There is a memory leak—when members are found and the song is played, some data is not disposed of (the array of AEDescPtrs).
  29.  
  30. There is no error checking when a song is read in from the file.
  31.  
  32.  
  33. WRITING YOUR OWN SONG
  34. The data files are text files which are formatted as follows:
  35.   midi_frequency <space> duration, midi_frequency <space> duration, …,
  36. Several things to note about this:
  37.      There is NO error checking when the file is read.  Note however that returns and extra spaces are permissible at any point in the file.  However, you NEED A COMMA as the last character in the file.
  38.      midi_frequency can be found in Inside Mac VI or you can compute it yourself by using 60 as Middle C (72 is one octave higher...don't forget the sharps and flats!).
  39.      For rests, use 0 as the midi_frequency.
  40.      The duration is 2000 units per second.
  41. A late addition to the software (rather than fix the existing bugs) was to add a second voice.  In the data files, this is recorded by doing the first voice line in entirety ending with a semi-colon (;) rather than a command.  The second voice line follows but ends in a comma.
  42. If you are going to do your own song, I strongly recommend transcribing it in short parts to be sure you have the tempo and notes correct (and then merge them).
  43.  
  44. One note about the second voice, there is a problem synchronizing the voices (not a network problem, this is a problem on one machine).  I'm looking into this but there may not be a fix.  What I did was add a rest with a duration 30-50 to the first voice.  Also, it works better (sometimes? always?) if the parallel notes are the same duration (the notes run together so just make the first voice's half note into two quarter notes to match the two quarter notes in the second voice).  
  45. Conclusion:  FUDGE IT!  (I like chocolate anyways)
  46.  
  47. CONCLUSION
  48. There are probably other things that should be in this file but I can't think of them now.
  49.  
  50. Please send feedback, bugs, ideas, and enhancements to me via e-mail:  
  51.              brade@umich.edu
  52. I can also be reached at:
  53.     Kathleen Brade
  54.     108 John Street
  55.     Kinde, MI 48445
  56.  
  57. P.S. New versions may or may not be released.  Contact me for details.
  58.  
  59.  
  60.  
  61. Special Thanks to John Ardussi, Jim Reekes, and Mark Smith.
  62.  
  63.